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1 . Purpose of the Document 

This document provides an overview of the prerequisites and settings 
required to implement the keyword-driven framework in Selenium RC 
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2 . Framework Implementation in Selenium 

The keyword-driven framework is an application-independent framework 
that performs all possible actions and verifications on an object. 
Hence, the code for the same object can be used across different 
applications . 

2.1. Test Settings for Keyword-Driven Scripting 

In the keyword-driven approach, the entire script is developed with 
keywords. The script is developed in a spreadsheet that is 
interpreted by the main driver script, which then uses the function 
library to execute the complete script. 

a. The test suite, test script, object repository and report folder 
location should be mentioned in Selenium_Utility excel. 



File\Folder 

Name 


Location 


Test Suite 


C:/lnnovez/Selenium Automation/Test Suite.xls 


Test Script 


C:/lnnovez/Selenium Automation/Test Scripts/ 


Object 

Repository 


C:/lnnovez/Selenium_Automation/Test_Data/Object_Repository.xls 


Summary 

Report 


C:/lnnovez/Selenium Automation/Test Reports/ 


Screen Shot 
Report 


C:/lnnovez/Selenium Automation/Test Reports/ScreenShot Repor 
t / 


Detailed Report 


C:/lnnovez/Selenium_Automation/Test_Reports/Detailed_Report/ 



Note: The selenium utility excel file should be placed in 
C : \Documents and Settings\Mantis\Demo-Selenium\Selenium_Utility . xls 



b. Collect the properties of objects and define it in 
Object_Repository.xls like below 



ObjectName 


Objectldentification 


ObjectType 


Username 


username 


TextBox 


Password 


password 


TextBox 


Login 


//input[@value='Login'] 


Button 


Manage 


link=Manage 


link 


Manage Projects 


link=Manage Projects 


link 
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c. Define the test scripts in the test suite Excel like below 



Run 


Test Driver 


r 


Mantis_Create Project 


r 


Mantis_Report Issue 


r 


Mantis View Issue and Delete Project 


r 


Mantis Fail 


r 


Call Tariff Addition and Amendment 



d. Write the keywords for the test script like below 



Step 


Operation 


Object 


Action 


r 


callaction 


C:\Documents and Settings\Mantis\Demo- 

Selenium\lnnovez\Selenium_Automation\Test_Scripts\Login 

Action.xls 




r 


perform 


link;Manage Projects 


click 


r 


wait 


3 




r 


perform 


Button ;Create New Project 


click 


r 


perform 


Textbox;Project Name 


set:Selenium 
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3 . Selenium RC - Server up 



• Starting the server: 

java -jar selenium-server . jar -interactive 



C:\WINDOWS\system32\cmd.exe java -jar selenium -server. jar -interactive -multiwindow 



<C> Copyright 1985-2001 Microsoft Corp. 

C:\Documents and Settings\029893>cd. . 

C:\Documents and Settings>cdN 
C:\>cd selenium-remote-control-1 .0-beta-2 

C : \s e le n iun-r e mo t e -c o n t r o 1—1 .0-beta-2>cd s e le n ium-s e rv e r-1 . 0-be t a-2 

|C : \s e le n iun-r e no t e -c o n t ro 1—1 . 0-be t a-2 \s e le n ium-s e rv e r-1 .0-beta-2>java -jar selen| 
iun-seruer. jar -interactive -multiwindow 



[12 : 04:22 .854 

12:04:22.886 

12:04:22.886 

12:04:23.511 

112:04:23.542 

/driver I 

12:04:23.558 

12:04:23.558 

12:04:23.636 

12:04:23.636 



INFO - Java: Sun Microsystems Inc. 1.6.0-bl05 
INFO - OS: Windows XP 5.1 x86 

INFO - vl.0-beta-2 12571 1, with Core vl.0-beta-2 12330 1 
INFO - Uersion Jetty/5. 1.x 

INFO - Started HttpContext I/selenium-server/driver./selenium-servei 



INFO - Started HttpContext I/selenium-server, /selenium-server I 
INFO - Started HttpContext [/,/] 

INFO - Started SocketListener on 0.0.0.0:4444 
INFO - Started org.nortbay . jetty .Server0201f 9 
[Entering interactive mode... type Selenium commands here <e.g: cmd=open8<l=http:/| 
/wmw . yahoo .con) 

■ 



Figure 1 : Selenium RC server up and running 
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4 . Managing Object Repository 

Selenium must learn the interface of an application to be able to work 
with it. It does this by learning the application's objects and their 
corresponding property values and storing these object descriptions in 
an object repository file. There are two types of object repositories: 
the shared object repository, and the per-action object repository. 

The same object repository file can be used for multiple tests if the 
tests include the same objects. Object information that applies to many 
tests is kept in one central location and the read-only copy of the 
repository is associated with the tests. 

Here the object repository is maintained in the form of Excel sheets. 
XPath is also installed as a plug-in to Firefox. To identify the object 
properties, open Firefox browser, right click on the object and select 
Show in XPather . The XPather Browser window opens and XPath value is 
used as the object with logical names. 

For Internet Explorer, make use of its add-in 'Developer Too' to get the 
unique id or text for the object. 
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’) XPather Browser 



^]n]x] 



XPath- 



/html/body/form/table/tbody/tr[2]/td/table/tbody/tr[5]/td/input 



Eval 



RegExp 



Subst 



Matching Nodes (count: 1 from 1 ) 



| full XPath~ 



no content 



1 



/html/body/f orm/table/tb . . . 



Content of the selected nodes 
Text | Inner HTJ^^Wfib-Clipping — XPaths | Tnfn _j 





Figure 3: XPather - Object Identification 
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5 . Call to Framework 

The Main.rb should be opened in the SciTE. Press F5 and this will call 
the framework file associated with the test and perform the actions by 
interpreting the keywords specified in the data table. 

Instead of pressing F5, we are able to run the main.rb by command ruby 
<main . rb> 




Figure 4 : Call to Framework 
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6 . Usage of Keywords 

The keywords should be entered in Sheetl of Microsoft Excel placed in 
the Test Scripts folder. The syntax for the keywords can be found in the 
Selenium Keyword Reference Dictionary Document. Below is an example of a 
simple keyword-driven scripting. 



KEYWORD SYNTAX FOR SAMPLE AUT 


Run option Operation 


ObjectDetails 


Input / Properties 


r 


check 


textbox;UserName 


editable 


r 


perform 


textboxjUserName 


set;Data_UserName 


r 


perform 


textbox;password 


set; Data_Pass word 


r 


check 


button;! ogin 


textpresent; Login 


r 


perform 


button;! ogin 


buttonjdick 


r 


perform 


button;verify 


buttonjclick 


r 


perform 


link;Account_Link 


link; click 


r 


perform 


link;Options_link 


Link; click 


r 


perform 


button;Reset 


button;click 



Figure 5 : 



Using the Keyword 
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7 . Test Results for a Keyword-Driven Script 

Test execution results can be viewed and analyzed as soon as the run 
session ends. To access the test results, go to the Test_Reports folder 
customized using the Test automation framework. Two folders will be 
available: one showing the summary report for Test suite execution, and 

another folder Detailed_Report displaying the detailed step-wise test 
results for the each test script. A screenshot will be available for the 
failure scripts under ScreenShot_Report . 




Automation Test Results 



Test Details : 



Run Date 


1 27 Aug 2009 


Run Start Time 


j 27 Aug 2009 14:35:04 


Run End Time 


j[27Aug 2009 14:37:08 


User Requested 


| Client Name 


Environment 


| Production 


Release 


j R2.1 



Test Result Summary : 



Total Test 
Total Pass 
Total Fail 



0 | o.ovg 

Detailed Report : 



: 100.0* 
lioo.o* 



| Test Script# | 


Test Case Name 


| Status | 


Screen Shot 


T 


Mantis Create Project 


Passed 


Not Available 


1 “ 


Mantis Report Issue 


Passed 


Not Available 


i I r 


Mantis View Issue and Delete Project 


Passed 


Not Available 




Mantis Fail 


Passed 


Not Available 



27 Aug 2009 14:35:04 
27 Aug 2009 14:35:28 
27 Aug 2009 14:36:09 
27 Aug 2009 14:37:00 



4 My Computer 



Figure 6: Test Results summary for a Test suite 
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-0 Detailed Test Results - Windows Internet Explorer 



B0® 



\j0 C:\Innovez\Mantis Scripts\Innovez\Selenium_Automation\Test_Reports\Detailed_Report\Mantis_Create Project_27_08_200< v X [ Search P|' r 

& <$t £ Detailed Test Results - 0 ^ ’ Ills' E a 9 e Tools ▼ 



uetauea Keport - rvianiis_ureaie project 



Test Details : 



Run Date 


| 27 Aug 2009 14:35:04 


User Requested 


||Client Name 


Environment 


(Production 


Release 


|R2.1 



Detailed Report : 



Step/Row# 


1 Status 


Expected Result 


Actual Result 


2 


Done 


Application should be Launched 


(Application Launched Successfully 


3 


Done 


Should wait for 5 seconds 


|Waited for 5 seconds 


4 


Done 


Value ’sindhu' should be assigned to ’UserHame' 


Value 'sindhu' has been assigned to 'UserHame' 


5 


Done 


Value 'sindhu' should be assigned to 'Password* 


|Value 'sindhu' has been assigned to 'Password' 


6 


Done 


textbox Username should be clicked 


|textbox Username is clicked 


7 


Done 


The value in variable UserHame should be entered in the Edit Box: Username 


|The value in variable UserHame is entered in the Edit Box: Username 


8 


Done 


The value in variable Password should be entered in the Edit Box: Password 


The value in variable Password is entered in the Edit Box: Password 


9 


Done 


Button Login should be clicked 


Button Login is clicked 


10 


Done 


Should wait for 3 seconds 


|Waited for 3 seconds 


11 


Done 


link Manage should be clicked 


| link Manage is clicked 


12 


Done 


Should wait for 3 seconds 


|Waited for 3 seconds 


13 


Done 


link Manage Projects should be clicked 


|link Manage Projects is clicked 


14 


Done 


Should wait for 3 seconds 


|Waited for 3 seconds 


15 


Done 


Button Create Hew Project should be clicked 


|Button Create Hew Project is clicked 


16 


Done 


Should wait for 3 seconds 


| Waited for 3 seconds 


17 


Done 


Selenium - should be entered in the Edit Box: Project Name 


Selenium - is entered in the Edit Box: Project Name 


18 


Done 


Hew project for Test - should be entered in the Edit Box: Description 


|Hew project for Test - is entered in the Edit Box: Description 


19 


Done 


Button Add Project should be clicked 


(Button Add Project is clicked 


20 


Done 


Should wait for 3 seconds 


|Waited for 3 seconds 


21 


Pass 


The text Selenium should be present 


The text Selenium is present 


22 


Done 


Button logout should be clicked 


| Button logout is clicked 



jJ My Computer 



\ 100% - 



Figure 7 : 



Detailed Test Results for 



Test script 
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8 . Resource Files 

The resource files such as Framework Files, Shared Object Repositories, 
and Environment Variables that are associated with the test can be 
stored in the user's machine and can be obtained during test execution. 

Function libraries of the file type .rb, environment variables of file 
type .excel, and object repositories of file type .excel can be placed 
in the folder specified in the Utility Excel. 



File\Folder 

Name 


Location 


Test Suite 


C:/lnnovez/Selenium_Automation/Test_Suite.xls 


Test Script 


C:/lnnovez/Selenium_Automation/Test_Scripts/ 


Object Repository 


C:/lnnovez/Selenium_Automation/TesMData/Object_Repository.xls 


Summary Report 


C:/lnnovez/Selenium_Automation/Test_Reports/ 


Screen Shot 
Report 


C:/lnnovez/Selenium_Automation/Test_Reports/ScreenShot_Report/ 


Detailed Report 


C:/lnnovez/Selenium_Automation/Test__Reports/Detailed_Report/ 



Note: The selenium utility Excel file should be placed in 
C : \Documents and Settings\Mantis\Demo-Selenium\Selenium_Utility . xls 



Library files 

1 . Main . rb 

2. Functionlibrary . rb 
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H 




File Edit Search View lools Options Language Buffers Help 



i M a ' n . rb 2 f unctionlibrary . rb 



1 require "selenium" 

2 require "test/ unit" 



3 require 1 f unctionlibrary. rb 

4 require 'win32ole' 



5 $Report = nil 

6 

7 $Status = nil 

8 $Exp = nil 

9 $Act = nil 

10 

11 -class NewTest < Test::Unit::TestCase 

12 

13 - def setup 

14 @verification_errors = [] 

15 - if $selenium 

16 ©selenium = $selenium 

17 else 

18 ©selenium = Selenium::SeleniumDriver.new("localhost", 4444, "*firefox", "http://10.247. 11.47 :808G/Hant is/ login_pa 

19 ©selenium. start 



23 

24 ############### tear down function when it get invokes when exception occurs ################## #################### 

25 - def teardown 



31 

32 ####################### test_new function is heart of the test scripts, which drives the selenium functions ##################. 

33 - def test_new 



20 

21 

22 



end 

#@se I en i um .set_context ("test_ne w ", 11 i nf o ") 

end 



26 

27 

28 

29 

30 



#@selenium.stop unless $selenium 
assert_equal [], ©verification_errors 
@@excel.Quit 
@@excel = nil 

end 



34 

35 

36 

37 
3R 



importdata() 

end 

end 



< 



ttttttttttitttttttttitttttttit Pennrt r.\n^ iicerl tn rennrtinn stuff it########## tftf ; v 

> 



Figure 8 : Resource Files 
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Copyright 

This library is free software ; you can redistribute it and/or modify it under the terms of the 
GNU Library General Public License as published by the Free Software Foundation; either version 2 
of the License , or (at your option) any later version. 

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without 
even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 
Library General Public License for more details . 

You should have received a copy of the GNU Library General Public License along with this 
library; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, 
MA 02110-1301, USA. 
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